home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / tex / macros / distribs / nfss / readme.mz3 (.txt) < prev    next >
LaTeX Document  |  1992-11-29  |  14KB  |  259 lines
  1. % This file is part of the NFSS (New Font Selection Scheme) package.
  2. % ------------------------------------------------------------------
  3. \def\filedate{92/08/30}
  4. Copyright (C) 1989-1992 by Frank Mittelbach, Rainer Schoepf.
  5. All rights reserved.
  6. IMPORTANT NOTICE:
  7. You are not allowed to change this readme file.
  8. For distribution of changed or unchanged versions see readme.mz.
  9. Please do not request updates directly from us.
  10. This is a preliminary release of the new font selection scheme and its
  11. interface to LaTeX 2.09.  Please excuse the terseness of the
  12. documentation.
  13. 1) You should get the following files:
  14. ======================================
  15. 1a) Basic macros for setting up a new format file:
  16. -------------------------------------------------
  17. basefont.tex    File used during generation of format.  See nfss.tex.
  18. fontdef.dc      File containing font/shape definitions for 256 character
  19.                 TeX fonts as well as nonstandard fonts like the AMS
  20.                 symbol fonts, etc.  You need a TeX with a large value
  21.                 for the pool size to use this file.
  22.                NOTE: this file is an example file. You better use only
  23.                 parts of it copying them to your local fontdef.tex
  24.                 file.
  25. fontdef.max     File containing font/shape definitions for standard TeX
  26.                 fonts as well as nonstandard fonts like 256 character
  27.                 text fonts, the AMS symbol fonts, etc.  You need a TeX
  28.                 with a large value for the pool size to use this file.
  29.                NOTE: this file is an example file. You better use only
  30.                 parts of it copying them to your local fontdef.tex
  31.                 file.
  32. fontdef.ori     File containing font/shape definitions for the standard 
  33.                 TeX fonts which are needed to set up a LaTeX format 
  34.                 compatible with the old font selection.
  35. lfonts.new      File that should be used instead of the old lfonts.tex
  36.                 to set up a new LaTeX format.  See nfss.tex.
  37.         
  38. preload.dc      File that preloads some of the dc fonts.  May be
  39.                 used during initex run.
  40. preload.min     File that preloads the absolute minimum of fonts.  May
  41.                 be used during initex run.
  42. preload.xpt     File that preloads those fonts which are otherwise
  43.                 loaded by LaTeXs \documentstyle command if 10pt size
  44.                 is requested.  If you normally use 11pt or 12pt as a
  45.                 style option you shouldn't use this file but make a
  46.                 similar one.  May be used during initex run.
  47.                In older distributions this file was named preload.med.
  48. preload.ori     File that preloads more or less the same fonts as the 
  49.                 old lfonts.tex.  May be used during initex run.
  50. 1b) Sub styles for the new font selection scheme: 
  51. -------------------------------------------------
  52. dcfont.sty    Like newlfont.sty (see below) but sets up everything
  53.                 for using the DC fonts (i.e. the 256 character fonts
  54.                 with the Cork encoding) rather than the CM fonts.
  55. margid.sty      Makes math alphabet identifiers behave like commands 
  56.                 with one argument, i.e. use \cal{A} as syntax.
  57. newlfont.sty    Switches to new font selection if oldlfont is default.
  58.                 See article.
  59. nomargid.sty    Makes math alphabet identifiers behave like font
  60.                 switches, i.e. use {\cal A} as syntax.
  61. oldlfont.sty    Switches to old font selection if newlfont is default.
  62.                 See article.
  63. syntonly.sty    Defines \syntaxonly command which can then be used in
  64.                 the preample to suppress output (TeX will run \approx
  65.                 4 times faster).
  66. tracefnt.sty    Defines \tracingfonts integer. This is used to trace
  67.                 font switches etc.  Setting \tracingfonts to <number>
  68.                 in the preamble means:
  69.               1 Warnings are turned into error messages to show you
  70.                 the exact location of the problem.
  71.               2 Additionally, loading of external fonts are shown.  
  72.               3 Additionally, switching of text fonts is traced.  You
  73.                 will see a lot of information if you set \tracingfonts
  74.                 this high.
  75. 1c) Example files and documentation:
  76. ------------------------------------
  77. array.sty       The extension of the array and tabular environment
  78.                 as described in tugboat 9#3. This file is without
  79.                 documentation and not necessarily up to date. It is
  80.                 provided only to run nfss.tex. If you have a newer
  81.                 version of array.sty use it instead.
  82. concrete.doc    Unfinished style option which should serve as an
  83.                 example of how to use a style file to make new fonts
  84.                 known to the new font selection scheme.  This file is
  85.                 subject to changes!!
  86. euscript.doc    Style option documentation for using the Euler Script 
  87.                 letters drawn by Hermann Zapf in math mode. Also gives a
  88.                 good example on how to add new math alphabets to NFSS.
  89. exscale.doc     Style option documentation for using different math 
  90.                 extension fonts in different sizes.
  91. nfss.bug        This file contains a list of known problems, solved and
  92.                 unsolved. It also serves as a history file for
  93.                 important changes.
  94. nfss.tex        Article published in TUGboat 11#1 about the LaTeX
  95.                 interface to the new font selection scheme. See section
  96.                  3a on how to print it.                
  97.         
  98.                 Note that due to a misunderstanding 2 pages of the
  99.                 article are missing in TUGboat 11#1.  Therefore the
  100.                 whole article is reprinted in TUGboat 11#2.
  101.                 Unfortunately this version got a few errors reinserted
  102.                 which had been corrected for the first printing
  103.                 (that's life).
  104. nfssinst.tex    The part of nfss.tex (with some extensions) that
  105.                 describes the generation of a new format. It is
  106.                 processable by the old LaTeX.
  107. nfssprob.tex    User problem reports, during installation and/or use
  108.                 of the NFSS (New Font Selection Scheme). Usually with
  109.                 solutions.
  110.                 We only maintain and distribute this file. If you have
  111.                 a problem (and hopefully a solution to it) and you
  112.                 think this could be of interest to others, please send
  113.                 us your contribution as an update to this file. We
  114.                 then distribute it in the next release.
  115. readme.mz       File that describes distribution restrictions and gives
  116.                 a short overview about other distributions from Mainz.
  117. readme.mz3      This file.
  118. install.mz3     This is the installation script that will produce a few
  119.                 more executable files in this package and some driver
  120.         files for the documentation.
  121. 2) Installing the package:
  122. ==========================
  123. 2a) Generation of a new format (see also nfssinst.tex):
  124. -------------------------------------------------------
  125.   1)   Copy all files to a directory where TeX can find them.
  126.   2)   Rename the standard lfonts.tex to something like lfonts.old.
  127.   3)   Start IniTeX using lplain.
  128.   3.1) Use lfonts.new as a substitute for lfonts.tex
  129.   3.2) Use fontdef.ori as a substitute for fontdef.tex
  130.   3.3) Use preload.ori as a substitute for preload.tex
  131.   3.3) Use oldlfont.sty as a substitute for xxxlfont.sty
  132.   4)   Say \dump at the end of the run.
  133. This should generate a new format which behaves exactly like the old
  134. one, except, of course, that styles and files which use internals of the
  135. old lfonts.tex (like \xiipt or \tenrm) won't work without changes.
  136. 2b) Installing additional styles and documentation:
  137. ---------------------------------------------------
  138. To produce the executable files please run install.mz3 through LaTeX or
  139. TeX, i.e., say
  140.    latex install.mz3
  141. or whatever is necessary to run process a file with LaTeX on your
  142. system.  This will generate all necessary files. If you already have
  143. older versions of the files, the script will ask whether or not you
  144. want to overwrite those versions. Note, that the script calls
  145. docstrip.tex internally which is distributed in the doc package (MZ0).
  146. This script will generate the following files:
  147. concrete.sty    Stripped down version of concrete.doc without comments.
  148. euscript.sty    Style to set up a math alphabet identifier to access the
  149.                 Euler script fonts.
  150. exscale.sty     The style option for accessing different math extension
  151.                 fonts.
  152. scripts.sty    A style option contributed by Wayne Sullivan.
  153. concrete.drv    Driver for the documentation of concrete.
  154. euscript.drv    Driver for the documentation of euscript.
  155. exscale.drv     Driver for the documentation of exscale.
  156. To produce the documentation files run the corresponding driver files
  157. through LaTeX.  You are allowed to change the driver files to get a
  158. special layout, etc.  To get an index and history listing run the idx
  159. and glo files through the program MAKEINDEX.  MAKEINDEX should be part
  160. of every LaTeX installation.
  161. Please note that you need to specify a style file for MAKEINDEX:
  162.    gind.ist   for the index file   (result should be named *.ind)
  163.    gglo.ist   for the history file (result should be named *.gls)
  164. Sample invocation for Unix:
  165.    makeindex -s gind.ist concrete
  166.    makeindex -s gglo.ist -o concrete.gls concrete.glo
  167. 3) General documentation about NFSS:
  168. ====================================
  169. 3a) Producing the TUGboat article:
  170. ----------------------------------
  171. The article (nfss.tex) was changed to run under standard LaTeX without
  172. the font selection scheme so that you can look at the documentation
  173. without having to build a new format file first.  This document will
  174. tell you more about the font selection scheme and how it can be
  175. customized to the needs of your installation.
  176. But with the new format (see section 2a) you can process nfss.tex in a
  177. way that it looks like the original article.  
  178. If you have the concrete fonts you should uncomment the following two
  179. lines:
  180.   *  The line in the \documentstyle command where the concrete style is
  181.      loaded 
  182.   *  The line following directly after the \begin{document}, namely
  183.        % \fontfamily{ccr}\fontsize{10}{13pt}\selectfont
  184. You should also comment out this one 
  185.      \fontfamily{cmss}\fontsize{10}{13pt}\selectfont
  186. The unchanged document will produce the article using Computer Modern
  187. sans serif fonts.  Please don't change the file in other respects.  If
  188. you have problems running it, make a copy and change the copy. 
  189. Good luck!
  190. 3b) Changes not covered in the article nfss.tex:
  191. ------------------------------------------------
  192. The files fam.tex, latinit.tex and setsize.tex have been removed and
  193. their contents merged directly into lfonts.new.
  194. basefnt.tex was renamed to basefont.tex.
  195. The \fileversion and \filedate lines below are generated so that you can
  196. easily check differences from your version by using GREP or DIFF etc.
  197. Don't be surprised when some files show several version numbers.  The
  198. reason is that these files are generated from several source files (with
  199. the docstrip.tex program), and every source file includes its own
  200. version and date line. 
  201.         array.sty:       \fileversion{v2.1b}
  202.         array.sty:       \filedate{92/07/06}
  203.         basefont.tex:    \fileversion{v1.4d}
  204.         basefont.tex:    \filedate{92/09/22}
  205.         concrete.doc:    \fileversion{v1.0h}
  206.         concrete.doc:    \filedate{92/06/20}
  207.         dclfont.sty:     \fileversion{v1.4d}
  208.         dclfont.sty:     \filedate{92/09/22}
  209.         euscript.doc:    \fileversion{v1.0g}
  210.         euscript.doc:    \filedate{92/06/20}
  211.         exscale.doc:     \filename{exscale}
  212.         exscale.doc:     \fileversion{v1.0c}
  213.         exscale.doc:     \filedate{92/06/20}
  214.         fontdef.dc:      \fileversion{v1.1m}
  215.         fontdef.dc:      \filedate{92/05/11}
  216.         fontdef.max:     \fileversion{v1.1m}
  217.         fontdef.max:     \filedate{92/05/11}
  218.         fontdef.ori:     \fileversion{v1.1m}
  219.         fontdef.ori:     \filedate{92/05/11}
  220.         install.mz3:     \filedate{92/09/21}
  221.         lfonts.new:      \fileversion{v1.3h}
  222.         lfonts.new:      \filedate{92/09/24}
  223.         lfonts.new:      \fileversion{v1.0s}
  224.         lfonts.new:      \filedate{92/09/24}
  225.         lfonts.new:      \fileversion{v1.1e}
  226.         lfonts.new:      \filedate{92/08/19}
  227.         lfonts.new:      \fileversion{v1.1k}
  228.         lfonts.new:      \filedate{92/09/22}
  229.         lfonts.new:      \fileversion{v1.2f}
  230.         lfonts.new:      \filedate{92/09/11}
  231.         margid.sty:      \fileversion{v1.0c}
  232.         margid.sty:      \filedate{91/08/19}
  233.         newlfont.sty:    \fileversion{v1.4d}
  234.         newlfont.sty:    \filedate{92/09/22}
  235.         nfss.bug:        \filedate{92/09/20}
  236.         nfssinst.tex:    \fileversion{v1.0a}
  237.         nfssinst.tex:    \filedate{91/03/29}
  238.         nfssprob.tex:    \filedate{91/04/23}
  239.         nomargid.sty:    \fileversion{v1.0c}
  240.         nomargid.sty:    \filedate{91/08/19}
  241.         oldlfont.sty:    \fileversion{v1.3f}
  242.         oldlfont.sty:    \filedate{92/09/07}
  243.         preload.dc:      \fileversion{v1.0i}
  244.         preload.dc:      \filedate{91/12/02}
  245.         preload.min:     \fileversion{v1.0i}
  246.         preload.min:     \filedate{91/12/02}
  247.         preload.ori:     \fileversion{v1.0i}
  248.         preload.ori:     \filedate{91/12/02}
  249.         preload.xpt:     \fileversion{v1.0i}
  250.         preload.xpt:     \filedate{91/12/02}
  251.         readme.mz:       \filedate{92/07/07}
  252.         readme.mz3:      \filedate{92/08/30}
  253.         scripts.doc:     \fileversion{0.02}
  254.         scripts.doc:     \filedate{91/8/14}
  255.         syntonly.sty:    \fileversion{v1.0e}
  256.         syntonly.sty:    \filedate{90/04/05}
  257.         tracefnt.sty:    \fileversion{v1.0s}
  258.         tracefnt.sty:    \filedate{92/09/24}
  259.